home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 9 / AMUG BBS in a Box Volume IX (August 1993) (MacWizards).iso / Files / Prog / S / ShowOff.cpt / ShowOff.Doc < prev   
Encoding:
Text File  |  1988-11-14  |  6.3 KB  |  114 lines  |  [TEXT/MACA]

  1. ==============================================================================
  2.         ABOUT 'SHOWOFF' FOR LIGHTSPEED PASCAL
  3. ==============================================================================
  4.  
  5. The files contained in the StuffIt file are the first two training programs
  6. from the book "How To Write Macintosh Software" written by Scott Knaster of Apple.
  7.  
  8. For those of you just starting to program on the Macintosh, I highly recommend
  9. this book.  Scott has done an excellent job of making the Macintosh programming
  10. environment understandable.
  11.  
  12. Believe me when I say that programming an easy to use program for the Mac is much more complex than using the finished product.  
  13.  
  14. The program 'ShowOff' is introduced in chapter 7 of the book, 'Real Live Debugging'.  For those programming in LightSpeed Pascal 'debugging' is sort of an understatement, it can take hours just to get to the point of starting to debug along with the book.
  15.  
  16. The Pascal program 'ShowOff' is written in MPW Pascal, which differs from LightSpeed in several ways, the most obvious being that MPW accepts incompatible 'typing' on a single line of MPW Pascal code.  
  17.  
  18. While this is nice for MPW Macintosh programmers, as the Mac environment forces mixing of types with regular frequency, it can be quite frustrating when MPW source is used with a 'classical' Pascal compiler, in as far as 'typing' is concerned.  LightSpeed is such a complier.
  19.  
  20. The first program is 'ShowOff 7-1'.  This is the first exercise in debugging a Mac program.  This version is converted to LightSpeed, with all 'bugs' intact so you may happily go 'bug hunting'.  Except as noted in the source code this version is the same as in the book, just converted to LightSpeed.
  21.  
  22. The second program is 'ShowOff 7-2' this is the debugged version and matches, with the conditions stated above, the book program 'Listing 7-2'
  23.  
  24.  
  25. ========================================================
  26. === Instructions For Running Under LightSpeed Pascal ===
  27. ========================================================
  28.  
  29. From within the LightSpeed program:  (SUBSTITUTE THE PROGRAM VERSION FOR 'X').
  30.  
  31.   1) Select 'OPEN PROJECT' from the 'PROJECT menu. Open 'ShowOff 7-X.proj'.
  32.   2) This will open the project file with the items:
  33.        MacPasLib
  34.        MacTraps
  35.        ShowOff 7-X.pas
  36.      and the RUN OPTIONS set to use resource file 'ShowOff 7-x.Rsrs
  37.                                                       
  38.   3) Choose the 'RUN OPTIONS' under 'PROJECT' and pick 'use resource file'.
  39.      Pick the resource file 'ShowOff 7-X.Rsrs' for use when compiling}
  40.   4) Select 'GO' and you'll be off and running.
  41.  
  42. That's all there is to getting it to run, have fun.
  43. ========================================================
  44.  
  45. For those of you who are just learning to program either the Macintosh or LightSpeed Pascal I offer these conversions of SHOWOFF, FREE and in the
  46. PUBLIC DOMAIN to ease your learning curve.  Pass the entire PackIt file to as
  47. many BBSs as you wish.  This is a small token of gratitude for all the
  48. freeware I've received for the Macintosh.
  49.  
  50. Thanks goes to Larry Rosenstein of Apple for his help in setting me straight
  51. on a couple of subjects during my learning curve on the Mac.
  52.  
  53. =========================== MINI ADVERTISEMENT ========================
  54. Also look for other source code offerings through the ShareWare program.
  55. All source code includes extensive comments (Even I need them to remind
  56. me what I did a week earlier), resource files if used and complete ready to
  57. run projects to open from LightSpeed products. So far all programs are 
  58. suitable for use as application shells. Presently two programs are available:
  59.  
  60. 'Text Convert'- in LightSpeed Pascal and LightSpeed C - A simple application 
  61. to convert text file line endings to be Mac or IBM compatible. A nice shell program with many Mac features ready to modify for your use. This one is nice
  62. for those of you learning LightSpeed 'C' who want some examples of a Pascal
  63. and 'C' program which do the same things.  The 'C' version was converted as
  64. closely as possible directly from the Pascal version..  Having both helps to
  65. understand the conversion of the "Inside Macintosh" calls, which are written
  66. in Pascal.
  67.  
  68. 'IFSv1.xx'- in LightSpeed C - A graphics program for decompressing a graphic
  69. picture stored in 'Iterated Function System' format. Supports original style
  70. 8 color operations (so it runs on Mac Plus, SE and II).  Included are a 
  71. normal Mac verison and a 68881 version to take advantage of the Mac II's
  72. floating point coprocessor to speed up the calculations.
  73.   ** If you are mainly looking for a nice Shell program, this is my latest and
  74.      greatest, includes radio and check boxes, static text and edit items
  75.      inside a dialog to allow modification of program specific variables or
  76.      run time options.
  77.  
  78. Both programs, while being useful and fun applications, are really ment to be
  79. applicaiton shells.  Complete with many Macintosh user interface features of 
  80. interest to many programs. Features include: menus control, multiple
  81. window operations, WindowPicture saving for automatic window information 
  82. upating, growing, zooming, text file loading and saving, DA operation etc.
  83.  
  84. Look for them on GEnie, CompuServe and the MacInfo BBS (415) 795-8862. Either
  85. program's source code may also be ordered for a ShareWare registration fee
  86. as specified below.
  87.  
  88.   If you would like the source code of the latest version of either
  89.   program, please send $5 per program (or $7.50 and 2 800K disks for both),
  90.   a ** 800K ** disk PER PROGRAM and a STAMPED self-addressed envelope
  91.   (strong enough to mail your disk in) along with your registration.
  92.   I WILL NOT SEND NEWEST VERSION WITHOUT YOUR DISKS AND SELF-ADDRESSED-STAMPED
  93.   ENVELOPE. Please specify which version you want, 'Text Convert' will be in
  94.   both LightSpeed Pascal and C while 'IFSv1.xx' is only available in 'C'.
  95.  
  96.   Remember: If you send $7.50 and 2 800K disks you'll get both programs!!                                            
  97.   Stephen Scandalis
  98.   1414 Prince Edward Way
  99.   Sunnyvale, CA 94087
  100. =========================================================================
  101.  
  102. If you have comments, bugs to report etc. about something in the source code
  103. please contact me at the address above or on GEnie or CompuServe (I only go out
  104. every couple of weeks, so it may take awhile to receive an answer)
  105.  
  106. GEnie:         S.SCANDALIS
  107. CompuServe:    70167,2205  STEPHEN A. SCANDALIS
  108.  
  109.  
  110. Have fun,
  111.  
  112. Stephen Scandalis
  113.  
  114.